docs: optional AI-agent skill for Noah-MP (community contribution, no code changes)#253
Open
ktwu01 wants to merge 1 commit into
Open
docs: optional AI-agent skill for Noah-MP (community contribution, no code changes)#253ktwu01 wants to merge 1 commit into
ktwu01 wants to merge 1 commit into
Conversation
Adds a single line under a new 'Community resources' section linking an unofficial, community-maintained AI-agent skill for onboarding new Noah-MP users. No code, build, or default changes. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Hi Noah-MP maintainers,
I'm Koutian Wu (ktwu@utexas.edu), a researcher working on AI-assisted scientific
computing workflows at UT Austin. I write agent "skills": structured
markdown documentation that lets an AI coding agent (e.g. a CLI coding agent or
AI IDE) install, build, configure, run, debug, and contribute to a model with
less hand-holding than a cold prompt. I'm doing this for a family of
Earth-system models; Noah-MP is one of them, so I'll note up front that the
shape of this message is shared across that family. The Noah-MP skill itself is
specific to Noah-MP, and lives here:
https://github.com/earth-space-ai/noahmp-skill
This PR is a single small, optional pointer, concretely, adds one line under a new 'Community resources' section in README.md linking the skill repo, noting
that an unofficial, community-maintained agent skill exists. It changes no model
code, no build system, and no scientific defaults. If you'd rather not link it,
that's completely fine: close this and I'll keep maintaining the skill on my side.
The offer stands either way.
What a "skill" is
A directory (
SKILL.md+reference/*.md): a routing hub the agent readsfirst, then deep-dive docs it loads on demand. It encodes the procedural
knowledge usually picked up by working alongside an experienced developer.
Honest disclaimers (stated up front in the skill)
remains the source of truth; where the skill and upstream disagree, upstream
wins and I treat that as a bug.
drifted line numbers, stale fields, hallucinated flags). The skill says so and
tells the agent to cross-check upstream before acting.
license, which the skill links to and does not relicense.
Why it might be worth a look
It helps onboarding. As a concrete data point: I used this Noah-MP skill to help an undergraduate go from zero to a scoped, runnable regional simulation plan (Texas, 12.5 km, NLDAS-2 forcing, on TACC) in about 3 DAYS, spin-up reasoning and a budget/smoke-test plan included. The finished plan is in this repo under
examples/PLAN_Texas_12p5km_NLDAS2_TACC.md. The skill carried the procedural load (clone-with-submodules, configure, build-failure remediation, verification checkpoints) so the student could spend their time on the science instead of the plumbing.Credit where it's due
The skill is borrowed and learned from the NCAR/hrldas tutorial notebooks (Note1-Note4) by Cenlin He (NCAR/RAL, Noah-MP maintainer); it restructures that material for agent use. The acknowledgments section names the upstream maintainers and the
specific docs it draws on. Any errors or oversimplifications in the skill are
mine, not the upstream community's.
Happy to collaborate
I'd genuinely enjoy collaborating on AI-assisted workflows for Noah-MP. If
there's an official place such a skill should live, conventions to follow, or
checks to enforce, I'm glad to adapt it.
Either way, thank you for maintaining Noah-MP.
Koutian Wu
ktwu@utexas.edu
UT Austin
Google Scholar: https://scholar.google.com/citations?user=s9w1k-cAAAAJ
LinkedIn: https://www.linkedin.com/in/ktwu01/